From 083a17acd4865acdc954e76cab5b4e8ee92d70b2 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Wed, 16 Dec 2015 17:32:24 -0500
Subject: [PATCH] gadget: Update docs

Make it clear that out_clip must be set.
---
 gtk/gtkcsscustomgadget.c | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/gtk/gtkcsscustomgadget.c b/gtk/gtkcsscustomgadget.c
index d627a1904f..60a1881ba9 100644
--- a/gtk/gtkcsscustomgadget.c
+++ b/gtk/gtkcsscustomgadget.c
@@ -76,6 +76,9 @@
  * don't have sub-gadgets of child widgets don't need a GtkCssAllocateFunc
  * (although it is still required to call gtk_css_gadget_allocate() on them).
  *
+ * Note that @out_clip *must* be set to meaningful values. If in doubt,
+ * just set it to the allocation.
+ *
  * GtkCssDrawFunc:
  * @gadget: the #GtkCssCustomGadget
  * @cr: the cairo context to draw on
-- 
2.30.2